An implementation of Amazon Ion for JavaScript written in TypeScript.
This package is designed with work with Node JS major versions 8, 10, and 12. Browser compatibility should be anything that supports ES5+.
You can use this library either as a Node.js module or inside an HTML page.
ion-js to your dependencies using npm
npm install --save ion-js
var ionJs = require("ion-js")
var ionData = "{ hello: \"Ion\" }";
var ionReader = ionJs.makeReader(ionData);
ionReader.next();
ionReader.stepIn();
ionReader.next();
var hello = ionReader.fieldName();
var ion = ionReader.stringValue();
ionReader.stepOut();
console.log(ion.concat(", ").concat(hello));
You can include the Ion-js bundle (ES5 compatible) using the URLs
These will create and initialize window.ion which has the same exact API as our npm package. Here is an example
<html>
<head>
<meta charset="UTF-8"/>
<script src="scripts/ion-bundle.min.js"></script>
<!-- more HTML/JS code that can now use `window.ion` to create/write Ion -->
</head>
</html>
TypeDoc generated documentation can be found at here. Please note that anything not documented in the the API documentation is not supported for public use and is subject to change in any version.
This repository contains a git submodule
called ion-tests, which holds test data used by ion-js's unit tests.
The easiest way to clone the ion-js repository and initialize its ion-tests
submodule is to run the following command.
$ git clone --recursive https://github.com/amzn/ion-js.git ion-js
Alternatively, the submodule may be initialized independently from the clone by running the following commands.
$ git submodule init
$ git submodule update
Use npm to setup the dependencies. In the project directory you can run the following:
$ npm install
Building the package can be done with the release script (which runs the tests).
$ npm run release
Tests can be run using npm as well
$ npm test
This package uses Grunt for its build tasks. For convenience, you may want to install this globally:
$ npm -g install grunt-cli
$ grunt release
Or you could use the locally installed Grunt:
$ ./node_modules/.bin/grunt release
The build above will compile the library into the dist directory. This directory has subdirectories of
the form <module type>/<target ES version>. In general, we target ES6 and rely on polyfills to support earlier
versions.
dist/es6/es6 - Targets the ES6 module system and ES6dist/commonjs/es6 - Targets the CommonJS module system and ES6dist/amd/es6 - Targets the AMD module system and ES6A distribution using browserify and babelify creates a browser friendly polyfilled distribution targeting ES5:
at dist/browser/js/ion-bundle.js.
| Types | IonText | IonBinary | Limitations |
|---|---|---|---|
null | yes | yes | none |
bool | yes | yes | none |
int | yes | yes | underscores, binary digits |
float | yes | yes | underscores |
decimal | yes | yes | none |
timestamp | yes | yes | none |
string | yes | yes | none |
symbol | yes | yes | $0, symbol tokens |
blob | yes | yes | none |
clob | yes | yes | none |
struct | yes | yes | none |
list | yes | yes | none |
sexp | yes | yes | none |
| annotations | yes | yes | none |
| local symbol tables | yes | yes | none |
| shared symbol tables | no | no | none |
Notes:
See CONTRIBUTE.md
This library is licensed under Apache License version 2.0
For more information about Ion or its other impleemntation, please see:
FAQs
A JavaScript implementation of the Ion data interchange format
We found that ion-js demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
ENISA’s 2024 report highlights the EU’s top cybersecurity threats, including rising DDoS attacks, ransomware, supply chain vulnerabilities, and weaponized AI.
Security News
NIST's new password guidelines remove periodic changes and special character requirements, focusing on longer, more secure passwords for better authentication practices.
Security News
A record 2,709 developers participated in the 2024 Ruby on Rails Community Survey, revealing key tools, practices, and trends shaping the Rails ecosystem.